home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / UTILITIE / CONVERSI / 0825C.ZIP / HC.DOC < prev    next >
Text File  |  1980-01-01  |  3KB  |  60 lines
  1. ***************************************************************
  2. *                         [[hc.com]]                          *
  3. ***************************************************************
  4.  
  5.                a Useful Utility by Marty Smith.
  6.  
  7. Hex File converter.  Converts to and from HEX format. Can
  8. automatically provide a COM or EXE extension.
  9.  
  10. Format:
  11.           >hc [d:][path]infile [[d:][path]outfile]
  12.  
  13. If TWO files are supplied, one of them MUST be HEX.
  14. o       First file = HEX, program does HEX -> COM, EXE, BIN etc.
  15. o       First file = COM, EXE, BIN etc. program does COM -> HEX.
  16.  
  17. If ONE file is supplied, the following takes place:
  18. o       First file = no extension or anything other than HEX,
  19.                 Second file is created in HEX format.
  20. o       First file = HEX extension,
  21.                 Second file is created with COM or EXE extension,
  22.                         depending on file type.
  23.  
  24. If NO files are supplied, a short documentation is printed.
  25.  
  26. Ironically, you need a hexconverter if you download HC.HEX. If you are
  27. on a board with XMODEM protocol, you can download HC.COM directly.
  28. A third program, MAKEHC.BAS is a BASIC program that will create HC.COM.
  29.  
  30. This version corrects a lurking bug in the original which showed
  31. itself when trying to convert a large HEX file that appended a space
  32. at the end of each line. This ensured that somewhere HC had to convert
  33. a broken byte before and after a disk access, which was the problem.
  34. In fixing this HC's HEX->COM routine is further optimized, but now
  35. will not convert lowercase HEX files, not a problem at present.
  36.  
  37. There are a lot of hexconverters in for IBM(tm) and compatible
  38. computers, all following the same basic format.  HC.COM is compact,
  39. written entirely in 8088 assembler and capable of converting files up to
  40. the MS-DOS(tm) limit with no problem.  Total conversion time for a 70K
  41. hex download on floppies is about 15 seconds.
  42.  
  43. HC.COM uses only regular MS-DOS 2.x function calls, so compatibility
  44. should be no problem. PATH names are fully supported. Users of DOS 1.1
  45. and earlier unfortunately will not be able to use this program.
  46.  
  47. A hexconverter divides each byte into two bytes, so that all information
  48. in eight bit files is preserved in seven bit data transfers. When it
  49. operates in reverse, the hex file is converted back to its original form,
  50. and checked for accuracy with a number placed at the end of the file
  51. called a checksum. This is simply the number values of the bytes in the
  52. file added together modulo 2048 in this case.
  53.  
  54. Program by:
  55.  
  56. Marty Smith                  CompuServe   72155,1214
  57. 310 Cinnamon Oak Lane        (713) 661-1241 [Office]
  58. Houston, TX  77079           (713) 464-6737 [Home]
  59. 2/10/84
  60.